home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / nntpd / man / newsdb.5 < prev    next >
Text File  |  1995-08-16  |  6KB  |  198 lines
  1.  
  2.  
  3. NEWSDB(5)                                               NEWSDB(5)
  4.  
  5.  
  6. NAME
  7.        newsdb  - USENET network news database: article tree, his-
  8.        tory, active, active.times
  9.  
  10. DESCRIPTION
  11.        Each news article is stored in a separate file with one or
  12.        more  links,  each  a  numeric  name  in a directory under
  13.        uunews:  corresponding  to  a  newsgroup  the  article  is
  14.        (cross-)posted  to.   For  example,  an  article posted to
  15.        comp.unix.wizards      might      be       stored       in
  16.        uunews:/comp/unix/wizards/4867.
  17.  
  18.        The  file  uunews:/active  defines  the locally-valid news
  19.        groups and contains one line per group.   Each  line  con-
  20.        sists  of  four  blank-separated  fields:  newsgroup name,
  21.        highest local article number assigned, lowest local  arti-
  22.        cle number in use (approximately), and a flag.  Both arti-
  23.        cle-number fields are at least five  digits  wide.   (Some
  24.        older  news software may expect exactly five digits.)  The
  25.        current flag values are y (a normal unmoderated group),  n
  26.        (like y but local postings disallowed), m (a normal moder-
  27.        ated group), x (a locally-disabled group, no articles will
  28.        be  filed  here),  and = (followed by the real group under
  29.        which to file articles in this group; articles are treated
  30.        exactly  as if their Newsgroups: header specified the real
  31.        group instead of the  original  one;  highest  and  lowest
  32.        fields are ignored).
  33.  
  34.        The  file  uunews:/active.times  is  an  extension  of the
  35.        active file that records the arrival of new newsgroups  by
  36.        time  and  creator.   When a new newsgroup is created, the
  37.        group name, time of group creation (as seconds since  Jan-
  38.        uary 1, 1970, 00:00, GMT), and mail address of the creator
  39.        are appended as a single line.  The file  must  always  be
  40.        sorted  in  increasing  order  of the creation-time field.
  41.        The news software only appends to the file, which normally
  42.        suffices  to  ensure  this.   An  initial active.times for
  43.        already existing newsgroups, with all times equal  to  the
  44.        time  of its creation and all creators ``unknown'', can be
  45.        built    using    act.to.times    (see    newsmaint(8CN)).
  46.        Active.times  provides a quick way for newsreaders to tell
  47.        when new groups have arrived, without weird heuristics and
  48.        expensive schemes like storing old lists of newsgroups and
  49.        comparing them to the active file.
  50.  
  51.        The file uunews:/history contains one line for each  arti-
  52.        cle  received.   Each line consists of three tab-separated
  53.        fields: a Message-ID:, a complex  middle  field,  and  the
  54.        list of links to this article.  The links are separated by
  55.        blanks and are given as  pathnames  relative  to  uunews:,
  56.        except  that all the `/'s except the last one (between the
  57.        last component of the newsgroup name and the numeric arti-
  58.        cle  name)  are  replaced by `.'s.  If an article has been
  59.        expired or cancelled without being seen first, the list of
  60.  
  61.  
  62.  
  63.                            18 Nov 1994                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69. NEWSDB(5)                                               NEWSDB(5)
  70.  
  71.  
  72.        links and the tab before it are omitted.
  73.  
  74.        The middle history field potentially has several subfields
  75.        separated by tilde (~).  Currently only three are defined:
  76.        the arrival date, the expiry date, and an optional article
  77.        size in bytes.  The arrival date is a time_t (see time(2);
  78.        in  Unix  a  time_t  is  a  count of seconds since the GMT
  79.        beginning of 1970) expressed as a  decimal  integer.   The
  80.        expiry  date is another decimal time_t, or the contents of
  81.        the Expires: header from the message,  or  `-'  indicating
  82.        that there was no explicit expiry date given.
  83.  
  84.        There  are also index files to permit rapid history lookup
  85.        by message-id, typically  called  uunews:/history.dir  and
  86.        uunews:/history.pag.
  87.  
  88.        Also usually present now are overview files, one per news-
  89.        group; see newsoverview(5) for more detail on them.
  90.  
  91. EXAMPLES
  92.        A trivial active file.
  93.  
  94.             control 0000600006 600004 y
  95.             junk 0000000076 00074 y
  96.             comp.org.usrgroup 0000000006 00004 y
  97.             talk.bizarre 0000296123 292136 n
  98.             comp.sys.sun 0000050175 50173 m
  99.             list.sun-spots 0000000076 00076 =comp.sys.sun
  100.             comp.os.vms 0000000000 00000 x
  101.  
  102.  
  103.        A trivial history file.
  104.  
  105.             <3451@hcr.UUCP>     581905588~-    comp.text/1317 comp.sources.wanted/4200
  106.             <9383@alice.UUCP>   611934511~-
  107.  
  108.  
  109. FILES
  110.        uunews:/news/group/1234
  111.        uunews:/active
  112.        uunews:/active.times
  113.        uunews:/history
  114.        uunews:/history.dir
  115.        uunews:/history.pag
  116.  
  117. SEE ALSO
  118.        dbz(1),  readnews(1CN),  rn(1),  dbz(3Z),   getabsdate(3),
  119.        news(5),  newsoverview(5),  newssys(5),  expire(8CN), new-
  120.        shist(8CN),   newsmaint(8CN),   relaynews(8CN),    newsin-
  121.        vaders(9.1)
  122.  
  123. HISTORY
  124.        Active.times  invented by Mark Moraes and Geoff Collyer as
  125.        part of the C News project.
  126.  
  127.  
  128.  
  129.                            18 Nov 1994                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135. NEWSDB(5)                                               NEWSDB(5)
  136.  
  137.  
  138. BUGS
  139.        Reader implementors are warned that the various files men-
  140.        tioned  here--the active file, the history file, the arti-
  141.        cle tree itself, and the overview  files--in  general  are
  142.        not updated perfectly simultaneously.  Nor are they neces-
  143.        sarily updated in a predictable order.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                            18 Nov 1994                          3
  196.  
  197.  
  198.